home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / cmds.fmt / kgdb.man < prev    next >
Encoding:
Text File  |  1990-12-13  |  5.2 KB  |  135 lines
  1.  
  2.  
  3.  
  4. KGDB                      User Commands                      KGDB
  5.  
  6.  
  7.  
  8. _________________________________________________________________
  9.  
  10. NNAAMMEE
  11.      kgdb - A kernel debugger based on GDB
  12.  
  13. SSYYNNOOPPSSIISS
  14.      kkggddbb [-_m_t_m] [_g_d_b _o_p_t_i_o_n_s] [_k_e_r_n_e_l]
  15.  
  16. OOPPTTIIOONNSS
  17.      --mmttmm          Invoke the debugger  for  the  target  machine
  18.                    given  by  tm.  If specified, this option must
  19.                    proceed all other options. The list of  avail-
  20.                    able target machines include sun2, sun3, sun4,
  21.                    and spur.
  22.  
  23.      See the GNU GDB documentation for information about the rest
  24.      of the available options.
  25.  
  26. _________________________________________________________________
  27.  
  28.  
  29. DDEESSCCRRIIPPTTIIOONN
  30.      KKggddbb is a version of the GNU gdb debugger modified to  debug
  31.      Sprite  kernels.   This manual page only describes the parts
  32.      of kkggddbb that differ from ggddbb. The reader is referred to  the
  33.      GNU  GDB  documentation  and  gdb manual page for a complete
  34.      description of ggddbb.
  35.  
  36. DDIIFFFFEERREENNCCEESS FFRROOMM GGDDBB
  37.      The "attach" and "detach" commands of kkggddbb differ from those
  38.      of ggddbb.
  39.  
  40.      aattttaacchh machine
  41.           The attach command of kkggddbb takes  as  an  argument  the
  42.           hostname  or  internet  address  of a Sprite machine to
  43.           debug. The command assumes that the  specified  machine
  44.           is  in  the kernel debugging stub and will wait for the
  45.           machine to enter the debugger.  Once the connection  to
  46.           the  machine is established, the trap condition and any
  47.           unprinted syslog messages are displayed.
  48.  
  49.      ddeettaacchh [cont]
  50.           The detach command breaks the connection  between  kkggddbb
  51.           and the currently attached machine.  If any argument is
  52.           specified, the machine is continued before the  connec-
  53.           tion is detached.  When used with the "attach" command,
  54.           the "detach" command allows debugging multiple machines
  55.           from the same kkggddbb session.
  56.  
  57. AADDDDIITTIIOONNSS TTOO GGDDBB
  58.      KKggddbb supports several commands not found in ggddbb.   The  com-
  59.      mands are:
  60.  
  61.      ppiidd proc-id
  62.  
  63.  
  64.  
  65. Sprite v.1.0       Printed:  December 13, 1990                  1
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72. KGDB                      User Commands                      KGDB
  73.  
  74.  
  75.  
  76.           The pid command sets the focus of the debugger  on  the
  77.           process  whose process id is proc-id. Once a process is
  78.           choosen with the pid command, all stack reference  com-
  79.           mands  such  as  "backtrace" and "frame" will reference
  80.           this process's stack.  For example,  the  command  "pid
  81.           0xa1139"  followed  by  the  "backtrace"  command  will
  82.           display a stack backtrace of the process  with  pid  of
  83.           0xa1139.  Note  that proc-id can be any expression sup-
  84.           ported by kkggddbb.
  85.  
  86.      rreebboooott [string]
  87.           The  reboot  command  reboots  the   current   attached
  88.           machine.  The optional argument string is passed to the
  89.           kernel routine Mach_MonReboot.  Note that this  command
  90.           is  the  same  as typing "print Mach_MonReboot(string)"
  91.           followed by a break and a detach  command  except  that
  92.           the reboot command will work even if no symbol table is
  93.           loaded.
  94.  
  95.      vveerrssiioonn
  96.           The version command prints the kernel version string of
  97.           the  attached  machine.  This  command outputs the same
  98.           information as the command "print SpriteVersion()"  but
  99.           like  the  "reboot"  command  doesn't  require a symbol
  100.           table to be loaded.
  101.  
  102.      ddeebbuugg hostname
  103.           The debug command is  similar  to  the  attach  command
  104.           differing  only  in the case when the specified machine
  105.           is not already in the debugging stub. Rather than wait-
  106.           ing  for  the  machine  to  enter the debugger like the
  107.           attach  command,  the  debug  command  will  force  the
  108.           machine  into  the  debugger using the kkmmssgg program. In
  109.           order for this command to work, the kkmmssgg  program  must
  110.           be  available  in  the  current  search  path  of kkggddbb.
  111.           Because of its  anti-social  possiblities,  caution  is
  112.           urged in the use of the debug command.
  113.  
  114. DDEELLEETTIIOONNSS FFRROOMM GGDDBB
  115.      Several features of ggddbb are not available  in  kkggddbb  because
  116.      they  don't  apply  to  kernel  debugging.  Missing features
  117.      include the ability to start  and  kill  programs  with  the
  118.      "run"  and "kill" commands; to change the program's environ-
  119.      ment  and  terminal  characteristics  with  the   "set-env",
  120.      "unset-env",  "set-args", and "tty" commands; and  to handle
  121.      signals with "handle" and  "signal"  commands.  Additionaly,
  122.      ggddbb's core file processing such as the ccoorree command are also
  123.      not available in kkggddbb.
  124.  
  125.  
  126. KKEEYYWWOORRDDSS
  127.      gdb, kernel, debugging, kmsg
  128.  
  129.  
  130.  
  131. Sprite v.1.0       Printed:  December 13, 1990                  2
  132.  
  133.  
  134.  
  135.